home *** CD-ROM | disk | FTP | other *** search
/ MacUser Mac Bin 40 / MACUSER-MACBIN40A-1997-03.ISO.7z / MACUSER-MACBIN40A-1997-03.ISO / 特集⁄オンラインソフト / ゲーム&アミューズメント / アミューズメント / Citron 1.07J⁄E / 収録XCMD説明&サンプルスタック / XCMD⁄XFCN説明書 / kiwi説明書 < prev    next >
Text File  |  1996-12-17  |  5KB  |  105 lines

  1.  Kiwi XFCNは、HyperTalkではKeyDownメッセージ等を利用しないと調べられなかったキー入力状態を直接調べるためのXFCNです。また、先行入力されたキーやマウスクリックを無効にする機能も備えています。本XFCNを使うことで、今までよりきめ細やかなインターフェースを実現することができます。
  2.  
  3.   Kiwi XFCNは、落合  徹(ちゃい)が著作権を所有しています。自作のスタックなどに利用する場合は、当ドキュメントの「使用上の注意」の項を良く読んでからご使用ください。
  4.   なお、自作のスタック等にインストールする場合は、CitronをHomeスタックへインストールするか、ResEdit等のリソース関連ツールでKiwi XFCNをコピーしてください。
  5.  
  6. 【Kiwi XFCN】(Version 1.00      CodeWarrior Gold9使用 1996/9)
  7.  
  8. 0.更新履歴
  9. (Version 1.00      CodeWarrior Gold9使用 1996/9)
  10.   初回バージョン
  11.  
  12. 1.使い方
  13.  
  14.   以下に使い方を紹介します。
  15.  
  16.   Kiwiは以下の機能を持っています。
  17.  
  18.   ・入力されたキーキャラクターを返す
  19.   ・キーの先行入力を破棄する
  20.   ・マウスクリックの先行入力を破棄する
  21.  
  22.   以下で個別に解説します。
  23.  
  24. −入力されたキーキャラクターを返す
  25. 【形式】 Kiwi(GetKey,同期フラグ)
  26. 【解説】
  27.  同期フラグをfalseにするか省略すると、Kiwi実行時点で押されているキーのキャラクター(文字)を返します。同期フラグをtrueにすると、キーが入力されるまで待って値を返します(当然、スクリプトの実行はポーズしています)。
  28.  
  29. −キーの先行入力を破棄する
  30. 【形式】 Kiwi(FlushKey)
  31. 【解説】
  32.  Kiwi実行時点で先行入力されていたキー入力を全て無効にします。
  33.  
  34. −マウスクリックの先行入力を破棄する
  35. 【形式】 Kiwi(FlushClick)
  36. 【解説】
  37.  Kiwi実行時点で先行入力されていたマウスクリックを全て無効にします。
  38.  
  39.   ここまでの使用でKiwi呼び出し時に返される可能性のあるエラーメッセージは以下の通りです。エラーが起きた場合は、以下のリストの通り、先頭に「Error:」が付加されています。
  40.  
  41.   Error:Missing parameters  (パラメーターが無い)
  42.   Error:Unknown command!  (未知のコマンドが実行された)
  43.  
  44. 8.XCMDバージョン
  45.  
  46.   以下の方法で、  Kiwiのバージョンを調べることができます。
  47.  
  48.     Kiwi(XCMDVersion)
  49.  
  50.   the resultによって以下の書式のメッセージが取り出せます。
  51.  
  52.     Kiwi XFCN Version *.** by -Chai-
  53.     Kiwi XFCN PPCVersion *.** by -Chai-      (Power Macintoshバージョンの場合)
  54.  
  55.   4ワード目(*.**と表わしたところ)に必ずバージョンナンバーが格納されているので、チェックする場合はそれを対象にしてください。
  56.  
  57. 9.Kiwiの使用上の注意
  58.  
  59.  Kiwi XFCN 1996 (C) Copyright 落合  徹(ちゃい)
  60.  
  61.   当パッケージを使用してトラブルが起こった際に、本項を読んでいないといった理由は一切受け付けることはできません。内容主旨を理解したうえでご使用ください。
  62.  
  63.   再配付を行なう様な場合は許可を取ってください(店頭での配付や、他ネットでの配付も含む。有料・無料どちらの場合もお願いします)。
  64.   個人的使用、およびそれに準ずる範囲内を越えた利用の際は、次項の注意をよく理解した上で使用してください。
  65.  
  66.   当パッケージを使ったことによって生じた直接、間接の損害については、権利者および配付者は一切の責を負わないこととします。あくまで使用者の責任の範囲で運用を行なってください。
  67.  
  68. 10.XCMD/XFCNの使用上の注意
  69.  
  70.   当XCMD/XFCNの著作権その他の権利は落合  徹(ちゃい)が所有しています。無断で外部使用することを禁じます。この項の説明はstart usingなどで間接的にXCMD/XFCNを使用する場合(Citronでの利用)も、同じ扱いとします。
  71.  
  72.   Citronの登録ユーザーの方は、個人的使用、およびそれに準ずる範囲内で、自由にご使用ください。
  73.   PDSその他等で配付する場合は以下の通りとなります。いずれの場合も、配布者はCitronの登録ユーザーである必要があります。
  74.  
  75.   ・フリーウエアに収録して配付の場合は、原則として無料で許可を出します。
  76.   ・シェアウエアもしくはそれに準ずる形式の配付の場合は(あるいはフリーウエアでも有償にて配付する場合)、XCMD使用料(配付ソフト一種につき¥5000)をいただきます。
  77.   ・業務目的で使用する場合、利益を生む配付(市販も含む)を行なう場合は別途ご相談ください。XCMD使用料およびライセンス料をいただきます。
  78.  ・収録せずに利用する場合、すなわちstart using等でCitronに収録されたXCMD/XFCNを呼び出す場合は、上3項目に該当しません(つまり、無料ですし、連絡の必要もありません)。ただし、当然ながらXCMD/XFCNを使用するソフト(配布ソフト)のユーザーがCitronの登録ユーザーである必要があります。
  79.  ・当XCMD/XFCNを収録したフリーウエア/シェアウエア(もしくはこれらに準ずる形式の配布形態)を雑誌等の媒体にて配布する場合、シェアウエアもしくはそれに準ずる形式の配付とみなして、配布ソフト作成者あるいは配布者(雑誌等の媒体)より、XCMD使用料(配付ソフト一種につき¥5000)をいただきます。ただし、シェアウエアもしくはそれに準ずる形式の配付として既にXCMD使用料をいただいている場合は、二重に支払う必要はありません。
  80.  
  81.   連絡を取る場合は、2日〜1ヵ月の余裕をみておいてください。
  82.   無断使用が発覚した場合、賠償請求させていただくことがあります。
  83.  
  84.   どの場合もドキュメント等の目立つ場所に、以下の項目を記載してください。
  85.   文章スタイル等は変更なさってもかまいません。
  86.  
  87. ・Kiwi XFCNの著作権その他の権利は落合  徹(ちゃい)(Nifty:QGA01617)が所有しています。
  88. ・Kiwi XFCNを自作スタック等に使用なさりたい場合は、Nifty-Serve FMACHYPよりCitronスタックを入手し、登録した上でご利用ください。
  89. ・Kiwi XFCNを使ったことによって生じた直接、間接の損害については、XCMD作者および配付者は一切の責を負わないこととします。あくまで使用者の責任の範囲で運用を行なってください。
  90. ・無断使用が発覚した場合、賠償請求させていただくことがあります。
  91.  
  92.   あるいは、
  93.  
  94. ・Kiwi XFCN 1996 (C) Copyright 落合  徹(ちゃい)
  95.  
  96.  だけでも結構です。こちらの場合、ドキュメント及びスタック等の作品のアバウト表示の両方に入れて下さい。
  97.  
  98. 動作チェック環境
  99.   漢字Talk 7.5.3
  100.   HyperCard 2.3J
  101.   QuickTime 2.5E
  102.   Power Macintosh 8100/80AV,Macintosh LC630,Power Macintosh PowerBook 5300cs
  103.  
  104.   漢字Talk7以降なら、動作するものと思われます。
  105.